<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
            "http://www.w3.org/TR/REC-html40/loose.dtd">
<HTML>
<HEAD>



<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<META name="GENERATOR" content="hevea 1.08">
<LINK rel="stylesheet" type="text/css" href="umsroot.css">
<TITLE>
ECLiPSe Command Line Options
</TITLE>
</HEAD>
<BODY >
<A HREF="umsroot147.html"><IMG SRC ="previous_motif.gif" ALT="Previous"></A>
<A HREF="index.html"><IMG SRC ="contents_motif.gif" ALT="Up"></A>
<A HREF="umsroot153.html"><IMG SRC ="next_motif.gif" ALT="Next"></A>
<HR>

<H1 CLASS="chapter"><A NAME="htoc333">Appendix&nbsp;D</A>&nbsp;&nbsp;ECL<SUP><I>i</I></SUP>PS<SUP><I>e</I></SUP> Command Line Options</H1>

The ECL<SUP><I>i</I></SUP>PS<SUP><I>e</I></SUP> system has several parameters which may be specified on the
command line at invocation time. All the parameters are available with
the tty <TT>eclipse</TT>; with <TT>tkeclipse</TT>, only the <TT>-g</TT> and <TT>-l</TT>
parameters are available.
The parameters are as follows:
<DL CLASS="description" COMPACT=compact><DT CLASS="dt-description">
<B>&minus;b bootfile</B><DD CLASS="dd-description"> 
<A NAME="@default1220"></A>
<A NAME="@default1221"></A>
<A NAME="@default1222"></A>
Compile the file <I>bootfile</I> before starting the session.
Multiple -b options are allowed.
The file name is expected to be in the operating system's syntax.
The file is processed by
<A HREF="../bips/kernel/compiler/ensure_loaded-1.html"><B>ensure_loaded/1</B></A><A NAME="@default1223"></A>,
i.e. it can be a precompiled file or a source file, and file extensions
are added as specified there.
<BR>
<BR>
<DT CLASS="dt-description"><B>&minus;e goal</B><DD CLASS="dd-description">
<A NAME="@default1224"></A>
<A NAME="@default1225"></A>
Instead of starting an interactive toplevel, the system will execute the
goal <B>goal</B>. <B>goal</B> is given in normal Prolog syntax, and has to be
quoted if it contains any characters that would normally be interpreted by the
shell. The -e option can be used together with the -b option and is executed
afterwards. Only one -e option is allowed.
<BR>
<BR>
The exit status of the ECL<SUP><I>i</I></SUP>PS<SUP><I>e</I></SUP> process reflects success or failure of the
<A NAME="@default1226"></A>
executed Prolog goal (0 for success, 1 for failure, 2 for abort).<BR>
<BR>
When you only have a runtime installation of eclipse, the -e option
is compulsory because a runtime system does not have an interactive
toplevel.<BR>
<BR>
<DT CLASS="dt-description"><B>&minus;g size</B><DD CLASS="dd-description">
<A NAME="@default1227"></A>
This option specifies to which limit the memory consumption of the
ECL<SUP><I>i</I></SUP>PS<SUP><I>e</I></SUP> global/trail stack can grow.
The size is specified in kilobytes (followed by an optional K), in megabytes
(followed by M) or in gigabytes (followed by G).
The default is 128M, ie. 128 Megabytes.
The amount required for this stack depends on the program's data
structures and may need to be increased for very large applications.<BR>
<BR>
<DT CLASS="dt-description"><B>&minus;l size</B><DD CLASS="dd-description">
<A NAME="@default1228"></A>
This option specifies to which limit the memory consumption of the
ECL<SUP><I>i</I></SUP>PS<SUP><I>e</I></SUP> local/control stack can grow.
The size is specified in kilobytes (followed by an optional K), in megabytes
(followed by M) or in gigabytes (followed by G).
The default is 128M, ie. 128 Megabytes.
The local/control stack is unlikely to require more than this default.
If it does, it is probably caused by a programming error.<BR>
<BR>
<DT CLASS="dt-description"><B>&minus;D directory</B><DD CLASS="dd-description"> 
<A NAME="@default1229"></A>
<A NAME="@default1230"></A>
This options allows to explicitly specify the ECL<SUP><I>i</I></SUP>PS<SUP><I>e</I></SUP> installation
directory, i.e. the directory under which the system tries to find
the ECL<SUP><I>i</I></SUP>PS<SUP><I>e</I></SUP> runtime system and libraries. This option overrides
(and renders unnecessary) any setting of the ECLIPSEDIR environment
variable (Unix) or, respectively, an ECLIPSEDIR registry entry
(Windows) that may be in effect.<BR>
<BR>
<DT CLASS="dt-description"><B>&minus; &minus;</B><DD CLASS="dd-description">
The ECL<SUP><I>i</I></SUP>PS<SUP><I>e</I></SUP> system will ignore this argument and everything that follows on
the commmand line. The Prolog program will only see the part of the
command line that follows this argument.
</DL>


<HR>
<A HREF="umsroot147.html"><IMG SRC ="previous_motif.gif" ALT="Previous"></A>
<A HREF="index.html"><IMG SRC ="contents_motif.gif" ALT="Up"></A>
<A HREF="umsroot153.html"><IMG SRC ="next_motif.gif" ALT="Next"></A>
</BODY>
</HTML>
